home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Tools / glimpse-2.1 / README.install < prev    next >
Text File  |  1995-05-16  |  4KB  |  91 lines
  1. /* Copyright (c) 1994 Sun Wu, Udi Manber, Burra Gopal.  All Rights Reserved. */
  2. This is version 2.1 of the glimpse package - a tool to search
  3. entire file systems.  Please send any comments to glimpse@cs.arizona.edu.
  4. Check the file CHANGES for the changes since version 1.0 (there are
  5. many of them).  The files glimpse.1, glimpseindex.1, and 
  6. glimpseserver.1 are the manual pages.
  7.  
  8. Instructions for installing glimpse, glimpseindex, glimpseserver, and agrep:
  9.  
  10. 1. Both the agrep and index directories have individual Makefiles 
  11.    which you can use independently. You can make everything 
  12.    by just typing make in the root glimpse directory.
  13.  
  14. 2. To make individual binaries in a subdirectory "ddd", do the following:
  15.     cd ./ddd ; make ; cd ..
  16.  
  17. 3. To rebuild everything from scratch, do the following:
  18.     make clean
  19.    This however does not remove the binaries that currently exist in ./bin
  20.    You can then proceed with the above steps. However, see (4) below.
  21.  
  22. 4. A small quirk when making clean: if you make clean from the glimpse-root
  23.    directory, it will cleanup all subdirectories except the subdirectory
  24.    "libtemplate". You must do:
  25.     cd libtemplate ; make clean ; cd ..
  26.    to cleanup that subdirectory. This was necessary so that Glimpse's
  27.    makefiles could be kept independent of "libtemplate"'s makefiles (which
  28.    are a part of the Harvest source distribution).
  29.  
  30. 5. Glimpse was developed on Sun Sparcstations running SunOS 4.1.x. 
  31.    On other machines or operating systems, the following changes to the
  32.    makefiles might be necessary.
  33.    (NOTE: we provide Solaris, Dec OSF/1 and HP makefiles:
  34.    use
  35.     make -f Makefile.solaris
  36.    or
  37.     make -f Makefile.alpha
  38.    or
  39.     make -f Makefile.hp
  40.    respectively).
  41.    
  42.    We will try to make this more convenient in the future by distributing a
  43.    config-file so that changing the individual makefiles will not be necessary.
  44.  
  45. NOTES:
  46. ------
  47.  
  48.    People in our mailing list have commented that the 4 make files we provide
  49.    work on many other architectures too. We recommend that you do a pairwise
  50.    "diff" of these makefiles to find out whether they support the options you
  51.    need before trying to modify makefiles to suit your environment. Often a
  52.    few changes to compiler options, etc., are enough to port glimpse to a
  53.    new architecture / OS. Source code modifications are usually not necessary.
  54.  
  55.    We request you to mail us any changes to the Makefile (or the source) that
  56.    are necessary to port glimpse to your architecture, and the corresponding
  57.    binaries, so that we can include it in our distribution. We will appreciate
  58.    any suggestions and will duly acknowledge all contributions.
  59.  
  60. Some comments about portability:
  61. --------------------------------
  62.  
  63. 6. You must define DIRENT in agrep/Makefile, index/Makefile, compress/Makefile
  64.    to be 1 or 0 depending on whether your machine has /usr/include/dirent.h
  65.    or /usr/include/sys/dir.h. We found that on most machines/OSs like SunOS4.1,
  66.    Solaris, Ultrix, AIX, OSF/1, HPUX and SGI IRIX 5.3, DIRENT should be 1.
  67.  
  68. 7. On Solaris, "RANLIB" should be define to be "true" in
  69.    agrep/Makefile.solaris and compress/Makefile.solaris.
  70.  
  71. 8. On Solaris (at least the version we have), the library archive 
  72.    program "ar" is in /usr/ccs/bin/ar instead of /usr/bin/ar. 
  73.    You must define "AR" in agrep/Makefile.solaris and compress/Makefile.solaris
  74.    appropriately or set your PATH to include the appropriate directory name.
  75.  
  76. 9. On Solaris you have to link the glimpse executables with the
  77.    socket and nls libraries by specifying "-lsocket" and "-lnsl" to the
  78.    make rules for "glimpse" and "glimpseserver".
  79.  
  80. 10. On the DEC ALPHA and HP, the make variable "CC" was changed from
  81.    "gcc" to "cc".
  82.  
  83. 11. If you have the utime() routine and <utime.h>, define the make variable
  84.    UTIME to 1 in glimpse/Makefile and compress/Makefile. Else define it to 0.
  85.  
  86. 12. If you need to add any new macros or flags, you can edit the file:
  87.     glimpse/agrep/config.h
  88.    and add whatever is needed to make porting easy on your machine / OS.
  89.    This file is included throughout glimpse source code.
  90.  
  91.